home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 4 / MacMania 4.toast / / Tools&Utilities / suntar-205 / suntar 2.0.5.readme < prev    next >
Text File  |  1995-06-24  |  8KB  |  100 lines

  1. Versions history
  2.  
  3. 1.0 (6 April 1991) the first release
  4. 1.01 (26 May 91) added support for drives which are not drive 1 and introduced the "uuencoded dump" distribution format
  5. 1.1 (14 Oct. 91) the program was largely rewritten: more commands supporting more formats,  a fully rewritten interface, and it's now MultiFinder aware and System 7.0 friendly.
  6. 1.2 (15 Feb. 1992) Preferences settings are now saved, we've added an options box, and more. Unfortunately, this version was extremely bugged
  7. 1.2.1 (8 March 92)
  8. 1.2.2 (5 April 92)
  9. 1.3 (20 June 92) added support for POSIX tar multivolume archives. And it is much, much faster.
  10. 1.3.1 (18 July 92)
  11. 1.3.2 (31 Oct. 92) Fixed a number of bugs.
  12. 1.3.3 (6 March 1993)
  13. 2.0 beta 12 (7 Jan. 1994) see below
  14. 2.0.1 (10 July 94) a number of bug fixes and a few new features, including a "file truncate" option for the "clear sector" command and better handling of drag&drop
  15. 2.0.2 (4 Sept. 94) more bug fixes, and since we could spend a few days in the company of an Exabyte, now the support for tape units is much better
  16. 2.0.3 (1 Nov. 94) more bug fixes in tape handling, added a uuencoder
  17. 2.0.4 (12 March 1995) minor bug fixes (and a major one in tape handling), may keep its preferences in a separate file (useful for sharing a single copy over a net) and may convert character codes >127
  18. 2.0.5 (24 June 1995) a couple of bug fixes (not in the tape module…) and a few improvements, including a "time zone" option
  19.  
  20. New features of 2.0
  21.  
  22. a) it can open any volume (including non-mounted ones) and any SCSI
  23.    device, hence if you can connect a device to both a UNIX workstation
  24.    and a Mac there are chances that you may use it to transfer data.
  25. b) can create tar archives as files on a regular Macintosh volume
  26. c) can create MacBinary and BinHex 4.0 files (and uuencode in 2.0.3)
  27. d) can extract uuencoded files
  28. e) correctly converts MS-DOS text files (even "MS-DOS to UNIX" in 2.0.2)
  29. f) an "extension -> type&creator" table allows a better control of
  30.    the file types
  31. g) you may select files to be archived from a scrollable list which
  32.    allows multiple selections and UNIX-like pattern matching
  33. h) it knows about how MS-DOS marks defective sectors in floppy disks
  34. i) it can place an empty MS-DOS filesystem on a floppy disk
  35. j) "Extract from sector" is another way to select part of an archive
  36. k) View sector may optionally use a pure hexadecimal representation
  37. l) it supports pathnames longer than 99 characters (unfortunately
  38.    there are two different ways to extend tar, both are supported)
  39. m) ejecting the disk is less dangerous since suntar exiting from a
  40.    pause now checks that the disk in the drive is the correct one
  41. n) it may create a log file
  42. o) sometimes it's slightly faster
  43. p) no more need to use ResEdit to set buffer sizes and other options
  44.  
  45.  
  46. Known bugs
  47.  
  48.   SuperBoomerang 3.0/4.0 has a bug that creates incompatibilities with suntar and many other applications (the 2.0 version is OK, but it's incompatible with System 7). In other similar cases we modified suntar to become compatible with buggy programs, but in this case that would disable a useful feature and violate Apple rules. Anyway, an option removes the incompatibility (it's not in the options box, but among "rarely used options", only in expert mode).
  49.   It does not handle correctly multi-volume archives on devices opened by the "Open device" command.
  50.   It may have some incompatibilities with System 7.5 or previous incarnations of features made "official" with 7.5. E.g. it causes its hierachical Apple menu (Apple menu options) to recheck the list of recent files, and that takes a lot of time. We're working to fix that.
  51.  
  52. Compatibility
  53.  
  54.   Our experience and/or letters from previous users have reported successful use of suntar in exchanging data with the following UNIX machines:
  55.  
  56. Sun SPARCstation 1, 1+, 2, IPC, IPX, 10
  57. Sun 386i
  58. IBM RISC/6000
  59. NeXTstation
  60. Solbourne S4000  (a SPARCstation clone)
  61. HP 9000 model 370 with HP9122A or HP9153B drive unit
  62. DECstation 5000 running ULTRIX 4.3 rev. 43
  63. Siemens-Nixdorf MX500
  64. a Sony News workstation
  65. Silicon Graphics Workstations 4D, Indigo
  66. Bull DPX/ProStation (486DX) running SCO UNIX Sys V/386
  67. Zeos Notebook (386SX) running MWC Coherent 4.0
  68. a Taiwanese clone (AMD 386DX) running QNX 4.1
  69. a Macintosh IIfx running A/UX 3.0 (suntar can read/write its tar archives, I don't know whether it has problems running under it: suntar 1.3 could not find the floppy disk since its name is different under A/UX, suntar 2.0 may open a disk having any name but it was never launched under A/UX )
  70.  
  71. Only a couple of users reported problems (an HP 9000 and a 386 with SCO UNIX) but I couldn't identify the cause (defective hardware?).
  72.  
  73.  
  74. Copyright notice
  75.  
  76.   Suntar (Speranza's un-tar) is freeware, so you may freely distribute it and send it to other public domain archives, provided that the documentation and this file are kept with it. You may also include it in any shareware collection on floppy disk, CD-ROM or other means. If you send it to an archive which is more easily accessible from UNIX machines than from the Mac, maybe you should send it in both forms, the Mac files (or file, if compressed into an archive) for who can download it and the uuencoded file (which includes instructions to use it) for those who need to "bootstrap" their communication link between UNIX and the Mac, by creating a Mac disk containing suntar using only UNIX utilities and a 3.5" disk drive connected to an UNIX machine. Some archives might wish to store also the file which allows to perform the bootstrap from an MS-DOS machine, but since nobody wrote me that it was useful we're no more including it in the suntar package. Really, also the uuencoded file seems to meet scarce interest today.
  77.   All the routines for creating and extracting files in tar format, plus the MacBinary conversions are from the programs muntar 1.0 and mtar 1.0 © Gail Zacharias 1988, whose source code is available in public domain. We did a lot of little improvements (for example, muntar recognized only the main variant of MacBinary), added support for bar and multivolume tar archives, and transformed them from file format converters with a pure UNIX-like interface (under the MPW shell) to a communication program with a Mac-like interface. 
  78.   The PackIt extractions routines are from unpit 2 ©1986 Allan Weber (it's a UNIX program).
  79. The routines for MS-DOS disks (IBM-ize and the test for sectors marked bad) are from mtools, a UNIX package by Emmet Gray.
  80.   The color icons were sent us by Mark Duffield who edited and colored the icons we had designed.
  81.   Suntar was written in Think-C 4.0.5 and 5.0; the 1.0 version used Symantec's ANSI standard library, but starting from the 1.1 version suntar has a user interface library of its own, built from demo programs by Symantec (MiniEdit.c) and Apple Computer (TESample.c), with a lot of original additions.
  82.   Furthermore, we must thank all the users of suntar for their suggestions and their help in identifying problems: in particular, the tape support would have never worked without the help of beta testers and their patience in performing tests; Dominique Petitpierre was certainly the most helpful of them all.
  83.   The source code of 1.3.3 is already available in public domain, probably the same will be for 2.0 when the worst bugs will have been discovered and fixed.
  84.  
  85.   You may help us to make suntar better by sending your bug reports, suggestions and questions to:
  86.  
  87. mail address:
  88.                                 Sauro & Gabriele Speranza
  89.  
  90.                                 via Cappuccini 18
  91.                                 40026 Imola
  92.                                 Italy
  93. (yes, it's the town where a Formula 1 grand Prix takes place and, sigh, where Ayrton Senna died)
  94.  
  95. E-mail in INTERNET
  96.                                 Sauro Speranza
  97.                                 speranza@cirfid.unibo.it
  98.  
  99.                             12 March 1995
  100.